package org.yzhzc.system.controller.exam;

import io.swagger.v3.oas.annotations.tags.Tag;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.*;
import org.yzhzc.common.core.controller.BaseController;
import org.yzhzc.common.core.domain.R;
import org.yzhzc.common.core.domain.TableDataInfo;
import org.yzhzc.system.domain.exam.dto.*;
import org.yzhzc.system.domain.exam.vo.ExamDetailVO;
import org.yzhzc.system.service.exam.IExamService;

@RestController
@RequestMapping("/exam")
@Tag(name = "竞赛管理接口")  // 用于 Swagger 文档生成，描述该控制器的功能
public class ExamController extends BaseController {

    @Autowired
    private IExamService examService;

    /**
     * 获取竞赛列表
     *
     * @param examQueryDTO 竞赛查询参数
     * @return 返回符合条件的竞赛列表数据
     */
    @GetMapping("/list")
    public TableDataInfo list(ExamQueryDTO examQueryDTO) {
        // 调用服务层获取数据，并返回封装好的分页信息
        return getTableDataInfo(examService.list(examQueryDTO));
    }

    /**
     * 添加新的竞赛
     *
     * @param examAddDTO 竞赛添加参数
     * @return 返回操作结果，包含成功或失败的消息
     */
    @PostMapping("/add")
    public R<String> add(ExamAddDTO examAddDTO) {
        // 调用服务层的添加方法并返回操作结果
        return R.ok(examService.add(examAddDTO));
    }

    /**
     * 添加竞赛题目
     *
     * @param examQuestAddDTO 竞赛题目添加参数
     * @return 返回操作结果
     */
    @PostMapping("/question/add")
    public R<Void> questionAdd(@RequestBody ExamQuestAddDTO examQuestAddDTO) {
        // 调用服务层的题目添加方法并返回操作结果
        return toR(examService.questionAdd(examQuestAddDTO));
    }

    /**
     * 删除竞赛题目
     *
     * @param examId 竞赛ID
     * @param questionId 题目ID
     * @return 返回操作结果
     */
    @DeleteMapping("/question/delete")
    public R<Void> questionDelete(Long examId, Long questionId) {
        // 调用服务层的删除题目方法并返回操作结果
        return toR(examService.questionDelete(examId, questionId));
    }

    /**
     * 获取竞赛详情
     *
     * @param examId 竞赛ID
     * @return 返回竞赛详细信息
     */
    @GetMapping("/detail")
    public R<ExamDetailVO> detail(Long examId) {
        // 调用服务层获取竞赛详细信息并返回
        return R.ok(examService.detail(examId));
    }

    /**
     * 编辑竞赛信息
     *
     * @param examEditDTO 竞赛编辑参数
     * @return 返回操作结果
     */
    @PutMapping("/edit")
    public R<Void> edit(@RequestBody ExamEditDTO examEditDTO) {
        // 调用服务层的编辑方法并返回操作结果
        return toR(examService.edit(examEditDTO));
    }

    /**
     * 删除竞赛
     *
     * @param examId 竞赛ID
     * @return 返回操作结果
     */
    @DeleteMapping("/delete")
    public R<Void> delete(Long examId) {
        // 调用服务层的删除竞赛方法并返回操作结果
        return toR(examService.delete(examId));
    }

    /**
     * 发布竞赛
     *
     * @param examId 竞赛ID
     * @return 返回操作结果
     */
    @PutMapping("/publish")
    public R<Void> publish(Long examId) {
        // 调用服务层的发布竞赛方法并返回操作结果
        return toR(examService.publish(examId));
    }

    /**
     * 取消发布竞赛
     *
     * @param examId 竞赛ID
     * @return 返回操作结果
     */
    @PutMapping("/cancelPublish")
    public R<Void> cancelPublish(Long examId) {
        // 调用服务层的取消发布方法并返回操作结果
        return toR(examService.cancelPublish(examId));
    }
}
